package com.waikuai.shop.service;

import com.baomidou.mybatisplus.extension.service.IService;
import com.waikuai.shop.entity.UserFavorite;
import com.waikuai.shop.vo.ProductSimpleVO;

import java.util.List;

/**
 * 用户收藏服务接口
 * @author waikuai
 */
public interface UserFavoriteService extends IService<UserFavorite> {

    /**
     * 获取用户收藏列表
     * @param userId 用户ID
     * @return 收藏列表
     */
    List<ProductSimpleVO> getUserFavorites(Long userId);

    /**
     * 添加商品收藏
     * @param userId 用户ID
     * @param productId 商品ID
     * @return 添加结果
     */
    boolean addToFavorites(Long userId, Long productId);

    /**
     * 取消商品收藏
     * @param userId 用户ID
     * @param productId 商品ID
     * @return 取消结果
     */
    boolean removeFromFavorites(Long userId, Long productId);

    /**
     * 批量取消收藏
     * @param userId 用户ID
     * @param productIds 商品ID列表
     * @return 取消结果
     */
    boolean batchRemoveFromFavorites(Long userId, List<Long> productIds);

    /**
     * 清空用户所有收藏
     * @param userId 用���ID
     * @return 清空结果
     */
    boolean clearFavorites(Long userId);

    /**
     * 检查用户是否已收藏该商品
     * @param userId 用户ID
     * @param productId 商品ID
     * @return 是否已收藏
     */
    boolean isFavorited(Long userId, Long productId);

    /**
     * 统计用户收藏数量
     * @param userId 用户ID
     * @return 收藏数量
     */
    Integer countUserFavorites(Long userId);

    /**
     * 统计商品收藏数量
     * @param productId 商品ID
     * @return 收藏数量
     */
    Integer countProductFavorites(Long productId);

    /**
     * 获取商品收藏用户ID列表
     * @param productId 商品ID
     * @return 用户ID列表
     */
    List<Long> getProductFavoriteUserIds(Long productId);

    /**
     * 切换收藏状态（收藏则取消，未收藏则收藏）
     * @param userId 用户ID
     * @param productId 商品ID
     * @return 操作后的收藏状态
     */
    boolean toggleFavorite(Long userId, Long productId);

    /**
     * 根据用户ID和商品ID查询收藏记录
     * @param userId 用户ID
     * @param productId 商品ID
     * @return 收藏记录
     */
    UserFavorite getByUserIdAndProductId(Long userId, Long productId);

    /**
     * 获取用户收藏的商品ID列表
     * @param userId 用户ID
     * @return 商品ID列表
     */
    List<Long> getUserFavoriteProductIds(Long userId);

    /**
     * 验证商品是否存在
     * @param productId 商品ID
     * @return 是否存在
     */
    boolean validateProductExists(Long productId);

    /**
     * 验证用户是否存在
     * @param userId 用户ID
     * @return 是否存在
     */
    boolean validateUserExists(Long userId);
}